home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 11 / FM Towns Free Software Collection 11.iso / t_os / tool / tmenusel / tmenusel.doc next >
Text File  |  1995-07-30  |  9KB  |  230 lines

  1. ---------------------------------------
  2.   Towns MENU 背景画 'TMENU.TIF' ランダムセレクター TMENUSEL
  3.   TMENUSEL: 'tmenu.tif' random selector (c)たくりん Jul 19 1995
  4. ---------------------------------------
  5.  
  6. ◆はじめに
  7.  
  8.  私は、フリコレ収録のグラフィックで、「TownsMENUの背景にいいな」と
  9. いうものがあると、それをHDDに複写しておいて、毎回起動時にその中の一枚をラ
  10. ンダムに選択し、表示するようにしています(フリコレ8収録の、BUN氏作のTo
  11. wnsMenu背景画選択プログラムTIFSEL.EXPを使用)。
  12.  しかし、フリコレも歴史を重ね、私の背景用TIFFも多数になり、フリコレごと
  13. にサブディレクトリに分けて管理したくなりました。そこで、複数のディレクトリの
  14. 中のTIFFファイルから、一枚を選ぶツールを作ってみました。
  15.  
  16. ◆概要
  17.  
  18.  指定されたディレクトリ内のTIFFファイルの中から、ランダムに一枚を選択し、
  19. 背景用TIFFである“tmenu.tif”に複写します。その際、圧縮TIFF
  20. を伸長したり、あるいは、その逆もできます。ディレクトリは複数指定したり、サブ
  21. ディレクトリを再帰的に対象にすることもできます。
  22.  ただし、TIFFファイルの色数や、縦横のサイズなどのチェックはしていません。
  23. 背景に使えないTIFF(256色など)が混ざっていても、処理してしまいます。
  24.  
  25. ◇動作環境
  26.  FM TOWNS/FM TOWNS II 全機種
  27.  TownsOS V2.1L20以降のコマンドモード上
  28.  
  29. ◇開発環境&動作確認
  30.  FM TOWNS II MA20(RAM 10MB)
  31.   + DX4カード(FMT-3624)
  32.   + 内蔵HDD 520MB(Fixel in TOWNS EBF-500)
  33.  TownsOS V2.1L50B
  34.   + High C Compiler マルチメディアキット V1.7L12
  35.  
  36. ◆ファイル
  37.  
  38.  tmenusel.doc:説明書(このファイル)
  39.  tmenusel.exp:プログラム本体
  40.  tmenusel.ggg:概要書
  41.  
  42. ◆使用法
  43.  
  44.  このプログラムは、コマンドモード(コンソール)上で使うように設計されていま
  45. すが、通常は、“autoexec.bat”内や、もしくは、パラメータを与えて
  46. アイテム登録したほうが良いでしょう。
  47.  
  48.   USAGE: run386 tmenusel -[cxlr] file_spec
  49.           c: Compress, x: eXpand, l: List
  50.           r: Recursively into sub-directory
  51.  
  52.  (1)cまたは、xの一方だけが指定できます。file_specに適合した全
  53. TIFFファイルの中から、ランダムに一枚を選択し、cの場合は圧縮、xの場合は
  54. 伸長します。
  55.  
  56.  (2)lは、file_specに適合するファイルのリストと、該当ファイル数、
  57. 今回ランダムに選択されたファイル名を表示します。下に例を示します。
  58.  
  59.         1 : E:/data/tmenu/fc03/file1.tif
  60.         2 : E:/data/tmenu/fc03/file2.tif
  61.         3 : E:/data/tmenu/fc03/file3.tif
  62.            (中略)
  63.       180 : E:/data/tmenu/fc10/file180.tif
  64.       181 : E:/data/tmenu/fc10/file181.tif
  65.     該当ファイル数 : 182
  66.     今回選択されたファイル : 155 番目
  67.       E:/data/tmenu/fc10/file155.tif
  68.  
  69.  (3)処理結果は、環境変数“TMENU”の示すディレクトリの“tmenu.
  70. tif”に出力します。環境変数が設定されていない場合は、カレントディレクトリ
  71. に出力します。
  72.  
  73.  (4)file_specには、DOSのワイルドカードが使用できます(ファイ
  74. ル名のみ)。拡張子は“.tif”のみが指定できます(省略した場合は、自動的に
  75. “.tif”を付け足します)。また、file_specに、ディレクトリ名を指
  76. 定すると(“.”や“..”も含む)、そのディレクトリ全体が対象となります。ディ
  77. レクトリ名を指定し、rオプションを指定すると、サブディレクトリも再帰的に対象
  78. となります。
  79.  
  80.  (5)file_specは、複数個書くことができます。オプションは、先頭に
  81. 指定してください。
  82.  
  83.  (6)オプションを何も指定しないと、lが指定されたものとみなします。
  84.  
  85.  (7)パラメータを一つも与えないときは、USAGEを表示します。
  86.  
  87.  (8)“autoexec.bat”内で使うと、毎回異なった背景で、立ち上げ
  88. ることができます。また、アイテム登録しておくと、TownsMENU上で、すぐ
  89. に背景を変更することができます。背景用のTIFFは、次のようなディレクトリに
  90. 格納してあるとして、それぞれ、例を示します。
  91.  
  92.  ・背景用TIFFの格納場所の例
  93.  
  94.     E:TOWNSITEM
  95.     \
  96.     +----BIN
  97.     +----DATA
  98.     |    +----ICN
  99.     |    +----IDX
  100.     |    +----TMENU
  101.     |         +----FC03    ←  これらのディレクトリに
  102.     |         +----FC04    ←
  103.     |         +----FC05    ←  背景用TIFFが
  104.     |         +--(中略)
  105.     |         +----FC10    ←  格納されている
  106.     +----GAME
  107.     |    +----ENOLA
  108.     (後略)
  109.  
  110.  ・“autoexec.bat”内の使用例
  111.  
  112.     (前略)
  113.     rem T-MENU背景画のランダムセレクト
  114.     \RUN386 E:\BIN\TMENUSEL -xr E:/data/tmenu  
  115.  
  116.     CONTROL -v -p -callbuf 32    ←  CONTROL~の直前が良いようです
  117.     GOTO EXIT
  118.     (後略)
  119.  
  120.  ・TownsMENUにおけるアイテム登録の例
  121.  
  122.     パス       E:\BIN
  123.     ファイル名        TMENUSEL.EXP
  124.     タイトル          背景変更
  125.     パラメータ        -xr E:/data/tmenu
  126.     アプリケーション  MS-DOS    ←  選択されたファイル名が分かります
  127.     ディレクトリ移動 なし
  128.  
  129. ◆プログラムの動作について
  130.  
  131.  ディレクトリの区切りは、“¥”と“/”のどちらも使えます。TMENUSEL
  132. が自身で使うのは“/”なので、“/”をおすすめします。
  133.  
  134.  通常、カレントディレクトリに、作業ファイルを生成しますが、環境変数“TMP”
  135. もしくは“TEMP”が設定されている場合は、その環境変数が示すディレクトリを
  136. 使用します(“TMP”の設定の方が優先されます)。
  137.  ディレクトリの記述は、末尾に“¥”がなくてもかまいません。ディレクトリを
  138. (環境変数“PATH”のように)複数指定したり、存在しないディレクトリを指定
  139. したり、ファイル名まで指定したりすると、エラーになります。
  140.  
  141.  対象となるファイルの数の上限や、処理できる画像のサイズは、メモリに依存しま
  142. す。画像のサイズは、背景に使用できるものに限られるので、あまり問題にならない
  143. と思いますが、適合するファイルの数が尋常でなく多いと、そのせいで、メモリ不足
  144. になる可能性があります。
  145.  
  146.  TMENUSELの名前が気に入らない場合は、TMENUSEL.EXP本体の
  147. ファイル名を変更してもかまいません。その際、画面のコマンド名表示部も変わりま
  148. す。
  149.  
  150. ◆作者より
  151.  
  152.  試しに、パラメータに“-lr Q:/”と指定して、フリコレ10の全ディレク
  153. トリの検索をしてみたところ、私の環境では、約8分かかりました。ファイルにリダ
  154. イレクトすると、一度に全TIFFファイルの格納場所を記録できます。
  155.  
  156.  私はパソコン通信をやっていませんので、他のユーザーの反応が見えません。そこ
  157. で、本作をインストールしてくださったかたや、使用されているかたは、次回のフリ
  158. コレ応募の際、ドキュメントのどこかに、「TMENUSEL使ってる」と書いてく
  159. ださると嬉しいです(どのくらいの人たちに使ってもらえるのか知りたいので)。
  160.  
  161.  それから、NETへのアップロードも大歓迎です。どなたか、していただけないで
  162. しょうか。連絡は、事後でも、なしでもかまいません。
  163.  
  164. ◆参考文献
  165.  
  166.  ・LZEXP V1.2 ソースファイル
  167.                        elfin氏作/フリコレ5収録
  168.  ・「MS-DOSプログラミングテクニック」
  169.                 アスキー書籍編集部編著/株式会社アスキー発行
  170.  ・「情報処理技術者試験 C言語短期征服 94秋試験対策」
  171.      山本和明・平井利明・渡邉彰・長谷川豊各氏著/株式会社学習研究社発行
  172.  
  173.  特に、LZEXPについては、ファイルの検索を行う部分をかなり参考にさせてい
  174. ただきました。このソースがなければ、本作は実現できませんでした。また、ソース
  175. の内容だけでなく、仕様やドキュメントの内容にいたるまで、多くの部分で模倣させ
  176. ていただきました。この場をかりて、作者のelfin氏に、感謝とお礼を申し上げ
  177. ます。
  178.  
  179.  また、「MS-DOS~」については、ファイル名における全角文字の処理におい
  180. て、非常に参考になりました。
  181.  
  182.  「情報処理~」については、リスト処理の項が参考になりました。
  183.  
  184. ◆初心者のかたへ
  185.  
  186.  TownsOSのコマンドモード(コンソール)は、そのままでは非常に使いにく
  187. いので、次のことを行うと、使いやすさが大幅にUPします。
  188.  
  189.  ・環境変数“PATH”を設定する
  190.  ・環境変数“PATH386”を設定する
  191.  ・環境変数“DOSX”に、“-nocrt”を設定する
  192.  ・386.COMを使用する
  193.  
  194.  注1)環境変数の設定のしかたや、環境変数“PATH”については、市販のMS-
  195. DOSの書籍などをご覧ください。
  196.  注2)386.COM(後藤俊明氏作)は、フリコレ5や、NIFTY-Serve
  197. FFMHOBのDL8などに収録されています(Oh!FM TOWNS 1995
  198. 年6月号より)。環境変数“PATH386”については、そのドキュメントをご覧
  199. ください。
  200.  注3)環境変数“DOSX”を参照するプログラムもあるらしいので、注意してく
  201. ださい。
  202.  
  203. ◆履歴
  204.  
  205.  ・Jul 16 1995 版(個人的に配布)
  206.  拙作LZTIFFのソースをもとに、開発。
  207.  EXP本体のファイル名が長いと正常に動作しないバグを解消。
  208.  
  209.  ・Jul 19 1995 版(フリコレ11収録)
  210.  ドキュメント等の誤記を修正。
  211.  ファイル選択時の、乱数の決定法を変更。
  212.  
  213. ◆使用、再配布等について
  214.  
  215.  本作はフリーソフトウェアです。無償である限り、自由に配布/転載/使用して下
  216. さって構いません。その際、ドキュメントファイル及び必須ファイル(あれば)を付
  217. 属して下さい。また、内容を改変した物や二次利用した作品は、その旨をドキュメン
  218. ト等に明示して下さい。
  219.  また、本作について(鑑賞料やプレイ料金等)金銭受領をする場合や、本作及び二
  220. 次利用した作品を有償配布する場合には、事前にご連絡下さい。
  221.  
  222.  本作品の使用、配布によるいかなる損害にも、作者は責任を負いません。
  223.  
  224.  ◇連絡先
  225.  
  226.  〒262 千葉県千葉市花見川区長作町1682-312 金子方 たくりん宛
  227.  
  228.  作品の感想、質問、バグ報告、改善提案等、作者への連絡は上記まで。
  229.  
  230.